home *** CD-ROM | disk | FTP | other *** search
/ Fritz: All Fritz / All Fritz.zip / All Fritz / FILES / DATATURE / WAMPUM42.LZH / WAMPDOC.EXE / lha / WAMPUM / README.DOC < prev    next >
Text File  |  1990-08-21  |  74KB  |  1,177 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.                       WAMPUM 4.2 Supplemental Documentation
  7.  
  8.      This documentation supplements the existing Second Edition, User's Guide
  9. and provides a thorough discussion of ALL new WAMPUM 4.2 features.  This format
  10. was chosen because of the substantial existing user base for earlier versions. 
  11. In short, you do not have to print or read the existing Second Edition User's
  12. Guide if you already have mastered it.  If you are new to WAMPUM, please read
  13. the User's Guide FIRST.  Only features of WAMPUM 4.0 forward are outlined here.
  14.  
  15.      WAMPUM continues to be one of the fastest and most powerful dBASE-
  16. compatible products on the market.  Individual files are "limited" to one
  17. billion records (if you can afford the disk storage).  400 fields per data base
  18. are supported, and memo fields are limited only by the amount of available
  19. system memory in your system. 
  20.  
  21.      WAMPUM 4.2 finally brings FULL relational power to the ShareWare market. 
  22. The breadth of new features also provides the best of every known data base on
  23. the market as well as a few specials of our own.  These include:
  24.  
  25.      *    WAMPUM now can be loaded as a pop-up TSR consuming less than 20K
  26.  
  27.      *    Version 4.2 directly supports .PCX image fields while retaining dBASE
  28.           file compatibility.  Hercules, EGA, and VGA monitors are supported.
  29.  
  30.      *    Fully relational table lookup from up to 9 "pop-up" data bases
  31.  
  32.      *    Reports and mailing labels using up to 5 relational data bases
  33.  
  34.      *    State-of-the-art form letters using up to 5 relational data bases
  35.  
  36.      *    Unlimited computational functions in RELATED data bases means you can
  37.           develop full-featured accounting or inventory systems without writing
  38.           a single line of program code!
  39.  
  40.      *    "Power Browse" brings the BEST full screen browse utility to the
  41.           market allowing complete edit, update, append, delete, and undelete
  42.           functionality on a single screen containing any selected group of
  43.           records from a data base of any size.  These records are displayed in
  44.           spreadsheet format (15 records per screen).  Hot keys allow you to
  45.           move to the top or bottom of the file as well as any particular record
  46.           by record number or by record key. 
  47.  
  48.      *    New UNIQUE table permits automatic generation of order numbers, part
  49.           numbers, or any other field requiring a unique key.
  50.  
  51.      *    New PHONFILE table brings a "pop-up" phone dialer to WAMPUM.
  52.  
  53.      *    New DOSAPPS table brings a "pop-up" DOS application menu to WAMPUM
  54.           permitting users to select and run DOS applications requiring up to
  55.           512K of memory WITHOUT EVER LEAVING WAMPUM.  Move over DesqView!
  56.  
  57.      *    New DITTO hot-key allows users with a single keystroke to instantly
  58.           duplicate any previously typed field data.
  59.  
  60. System Requirements:  512K PC/XT/AT/286/386/486 with DOS 2.1 or higher. DOS 3.1
  61. or higher is required for network applications.  Hard disk is strongly recom-
  62. mended although WAMPUM will run on a dual floppy system with at least one 720K
  63. or higher floppy drive.  WAMPUM requires 430K of free and clear RAM to load! 
  64. To display .PCX picture fields in your data bases, you must have either a VGA,
  65. EGA or Hercules-compatible graphics card and monitor.
  66.  
  67. Licensing:  90-day ShareWare license, no charge.  Single-user license, $50 per
  68. PC plus $5 shipping/handling ($10 foreign) for user's choice of latest available
  69. versions.  Network license, $150 per network server plus $5 shipping/handling
  70. for unlimited use on a single network.  Soft-bound Second Edition manual, $20.
  71.  
  72. Support:  90 days free telephone support by calling 404/237-9420 between the
  73. hours of 6 p.m. and 9 p.m. Eastern time, Monday through Thursday.  90 days free
  74. BBS or mail support to registered users in addition to telephone support.
  75.  
  76. Product Reviews:  Many ask whether WAMPUM has been evaluated and, if so, what
  77. the reviewers said about the product.  Here is a sample of reviews covering
  78. version 3 of WAMPUM:
  79.  
  80.           "WAMPUM is the best database manager I know of.  [It's] a
  81.           dBASE III clone that, in reality, is a great improvement over
  82.           the original.  It is not only a database manager with an
  83.           excellent, easy-to-learn interface, it is a complete
  84.           development package.  It features a long, impressive list of
  85.           capabilities and is fully file-compatible with dBASE III. The
  86.           documentation . . . is excellent explaining all the WAMPUM
  87.           functions in detail."  Jim Pile, PCM Magazine.
  88.  
  89.           "WAMPUM is comparable to dBASE III in features and power but
  90.           offers a menu-driven interface.  It uses a dBASE III -
  91.           compatible file structure and offers network support,
  92.           multiple indexes, relational functions, printer templates,
  93.           macros, and password protection."  George Campbell, PC World.
  94.  
  95.           "WAMPUM is well-conceived and well-implemented... impressive,
  96.           a must for anyone who seeks simplified dBASE capabilities. 
  97.           WAMPUM might be viewed as what Ashton-Tate's RapidFile should
  98.           have been, a menu-driven version of dBASE.  WAMPUM  is more
  99.           powerful and much cheaper than RapidFile and Alpha Three,
  100.           other attempts to put a menu face on dBASE.  With network
  101.           support and other clever features, WAMPUM is, in many ways,
  102.           more capable than dBXL." John L. Hawkins, Data Based Advisor.
  103.  
  104.           "The question may not be 'how much does it cost.' The only
  105.           valid question is 'Will it do the job for me?' . . . For
  106.           personal or recreational database use, WAMPUM is a gift-horse
  107.           that you can afford to 'look in the mouth.'  For business,
  108.           here is an industrial grade product full of embellishments. 
  109.           Indeed, WAMPUM is close to dBASE III Plus in performance." 
  110.           Hal Nieburg, Computer Shopper.
  111.  
  112.  
  113. And now, WAMPUM 4.2 brings you FULL RELATIONAL POWER plus ease of use and up to
  114. 50 per cent better performance than dBASE III Plus:
  115.  
  116.                  Using 10,000 records   WAMPUM    dBASE III Plus  
  117.                  ---------------------  -------   --------------                   
  118.                                          
  119.                  Index all records      17 sec.        27 sec.    
  120.                  Count random records    5 sec.         7 sec.    
  121.                  List random records     8 sec.        12 sec.    
  122.                  Replace all records    23 sec.        34 sec.    
  123.  
  124.  
  125.      WAMPUM has been developed and refined over a period of four years.  Hype
  126. aside, we think you will find it offers more features and performance per dollar
  127. than ANY other data base package in the world.  It was written the old-fashioned
  128. way, in a basement.  It was not developed by committee or by hired hands. And we
  129. have never spent one nickel advertising WAMPUM.  Consequently, it is also the
  130. least expensive data base package in the world.  We plan to keep it that way. 
  131. It might also interest you to know that the last "bug" report filed by a user
  132. was over 18 months ago.  If any of these diffferences from commercial products
  133. trouble you, then please feel free to look elsewhere for your DBMS product.  
  134.  
  135.      Our special thanks goes to the thousands of current WAMPUM users.  Most of
  136. the new features in version 4 are the result of their suggestions.  If you have
  137. ideas that would make WAMPUM a more useful product, please drop us a note. 
  138. We'd love to hear from you, too!
  139.  
  140.      The User's Guide fully explains the concept of ShareWare if you don't
  141. already know.  It is a "try before you buy" deal.  It does not mean use the
  142. software forever without compensating the author.  Unlike some ShareWare authors
  143. who receive substantial revenues from commercial sales of their products, we
  144. don't do this for one simple reason: it costs you money!
  145.  
  146.      We think you will find our support policies are more than satisfactory to
  147. get you up to speed quickly.  We have never received more than a few calls from
  148. any user.  The reason is that WAMPUM is a solid, easy-to-learn piece of
  149. software.  This should not lead you to believe you can learn it in a day.  An
  150. entire college education can be devoted to learning all there is to know about
  151. data base management systems.  WAMPUM strives to bring you a product with the
  152. richness of virtually all the best data base languages through a table-driven,
  153. menu interface.  That should not be confused with simplistic.
  154.  
  155.      While any dummy can create a data base, add a few records, and print a list
  156. or report, there is much, much more to WAMPUM.  It was designed to meet all the
  157. data base requirements of very sophisticated businesses and organizations.  What
  158. you get out of WAMPUM is directly proportional to the effort you are willing to
  159. put into learning it.
  160.  
  161.      Beginning with this version of WAMPUM, we will provide two years' worth of
  162. free WAMPUM updates to anyone who sends us an uncopyrighted, WAMPUM application
  163. which we deem sophisticated enough to place on our bulletin board system.  A few
  164. pages of documentation on disk also would be appreciated as well as a brief
  165. summary of the function of the application.  Please indicate which version of
  166. WAMPUM is required for the application, e.g. Clipper, dB3, or FoxBASE+.
  167.  
  168.      WAMPUM's power is derived from our use of the very best compilers in the
  169. personal computer data base market.  As you may have read, the so-called dBASE
  170. market is splintering badly as we enter the 1990's.  For this reason, future
  171. versions of WAMPUM may have significant differences depending upon the version
  172. you order.  The next page summarizes our current offerings.
  173.  
  174.      It should be noted that, as this version is released, dBASE IV still is NOT
  175. a reliable enough product upon which to develop a deliverable version of WAMPUM. 
  176. This may or may not change in the coming months or years.  
  177.  
  178.      FoxPro also has just been released.  It is a phenomenal product which will
  179. likely change the entire personal computer data base market. Nevertheless, there
  180. are licensing restrictions which we will need to work out with Fox Software
  181. before a new FoxPro-compatible version of WAMPUM can or will be released. 
  182. If you are interested in being kept abreast of new developments, send us a self-
  183. addressed, STAMPED envelope and we will mail you additional info when available.
  184.  
  185. The following software licenses currently are available from Ward Mundy
  186. Software, 4160 Club Drive, Atlanta, GA 30319 USA:
  187.  
  188. WAMPUM 4.2C (Clipper-compatible indexes)  is a full-featured, fully-relational,
  189. menu-driven, memory resident dBASE III Plus-compatible data base management
  190. system.  As with all current WAMPUM versions, WAMPUM 4.2C uses dBASE III-
  191. compatible data bases except users may opt to increase the number of data base
  192. fields beyond 128 and up to 400.  If the number of fields exceeds 128, then
  193. dBASE III file compatibility is forfeited.  This would mean that such data bases
  194. could no longer be used with products such as dBASE III Plus, dBASE IV,
  195. FoxBASE+, or FoxPro.  If performance is a key consideration and/or reliability
  196. on a network, we would recommend version 4.2C to you.
  197.  
  198. WAMPUM 4.2D (dBASE III+ compatible indexes) is virtually identical to WAMPUM
  199. 4.2C except that this version uses dBASE III Plus-compatible indexes.  Indexes
  200. are the supplemental files that WAMPUM uses to maintain sorts of your data base. 
  201. While the indexes are functionally equivalent to Clipper indexes, their internal
  202. format is different.  With large data bases, Clipper indexes tend to be much
  203. smaller and much faster in operation.  dBASE III Plus indexes are comparatively
  204. poor performers in a network environment.  However, if you use dLITE, dBASE III
  205. Plus or dBASE IV and need to maintain index as well as data base compatibility,
  206. we would recommend version 4.2D to you.
  207.  
  208. WAMPUM 3.3F (FoxBASE+ version) provides the functionality described in the
  209. Second Edition of the User's Guide.  Currently, it does NOT support version 4
  210. enhancements described in this README file.  Its other key difference from the
  211. above versions is that it relies upon the FoxBASE+ run-time interpreter which is
  212. licensed to you with the WAMPUM software.  Because FoxBASE+ is an interpretive
  213. language, it gives WAMPUM the added flexibility of providing you a simulated dot
  214. prompt or "command mode."  In this mode, you can enter dBASE-like commands just
  215. as you would with dBASE III Plus.  You also can write your own simple, unnested
  216. programs up to approximately 500 lines of code.  We do NOT provide technical
  217. support on matters regarding the command mode or programs you write.  Virtually
  218. any good dBASE III Plus reference book can assist you with the available
  219. commands in the dBASE language.  FoxBASE+ is a superset of that language.
  220.  
  221. WAMPUM 3.3C or 3.3D (Floppy-only versions) are available to those with no hard
  222. disk and no floppy disk support above 360K format.  2d Edition functions apply.
  223.  
  224. dLITE 1.1 (dBASE III+ compatible indexes) is a pop-up, memory resident desktop
  225. file manager.  It permits a user to access up to 10 different dBASE-compatible
  226. data base applications from within almost any text-based application.  In
  227. addition to powerful file management functions, dLITE also includes a unique
  228. paste function permitting users to extract data from any data base and stuff it
  229. into a word processing document, spreadsheet, or any other foreground appli-
  230. cation.  System requirements: 160K free RAM or 100K with 64K expanded memory.
  231.  
  232. Badge-O-Magic 2.0 (Clipper or dBASE III compatible indexes) is a program which
  233. produces one to four line badges or name tags using any LaserJet II-compatible
  234. laser printer.  Six soft fonts are included with the software providing type
  235. sizes of 12 to 40 points with automatic font sizing and centering on the badges. 
  236. This is the ideal product for those needing easy-to-read name tags for conven-
  237. tions, meetings, or social gatherings.  The software is completely menu-driven
  238. and includes a powerful file manager for manipulating dBASE III-compatible data.
  239.  
  240. MenuMaker is a software development tool which allows a developer to draw a data
  241. entry screen as it should appear with any of the WAMPUM or dLITE products. 
  242. Using point-and-shoot menus, the developer then links the data entry screen to
  243. the desired data base.  MenuMaker then writes the necessary application code.
  244.  
  245. I.  Developer's Power Browse
  246.  
  247.     WAMPUM 4.2 sets a new standard for full-screen BROWSE functionality in DBMS
  248. software currently on the market.  Instead of displaying one record for editing
  249. at a time, POWER BROWSE displays 15 records simulataneously.  Records quickly
  250. can be ADDED, CHANGED, DELETED, or UNDELETED within the POWER BROWSE facility.
  251.  
  252.     POWER BROWSE also allows you to predefine the sort order and group of
  253. records with which you want to work.  For example, you could select just records
  254. entered for a given month to browse.  Or, you could choose just those records in
  255. which a payment was overdue.
  256.  
  257.     To run POWER BROWSE, follow these simple steps:
  258.  
  259.     (1)  Start WAMPUM in developer mode by typing WAMPUM VOODOO at DOS prompt.
  260.  
  261.     (2)  Choose the file and indexes with which you wish to work.  Press ALT-I
  262.          from the Main System Menu to select the lead index for sorting data.
  263.  
  264.     (3)  Press ALT-S from the Main Menu if you wish to narrow down the group of
  265.          records to be used in POWER BROWSE.  Or, you may enter standard dBASE
  266.          selection criteria by choosing the S - Select Utilities option.
  267.  
  268.     (4)  If you want to work with a specific group of fields in the data base or
  269.          if you want to reorder the sequence of the field display, press ALT-B
  270.          and type Y when asked whether to select browse fields.  Highlight the
  271.          first field to be displayed and press <ENTER>.  Continue this process
  272.          for any additional fields you want to work with.  When finished, <ESC>.
  273.  
  274.     (5)  Choose S - Select Utilities option.  Use the <Down> cursor to move to
  275.          the Developer's Browse Mode option.  Type Y in this field and <PgDn>.
  276.  
  277.     (6)  The POWER BROWSE screen will appear.  A sample is shown below.  The top
  278.          box of the display tells you what special functions are available.
  279.  
  280.                |-------------------------------------------------|
  281.                | Use Arrows to MOVE, <CR> to EDIT, <ESC> to quit.|
  282.                |     ^Home - 1st Field   ^End - Last Field       |
  283.                |    ^PgUp - 1st Record   ^PgDn - Last Record     |
  284.                |-------------------------------------------------|
  285.                                                                  
  286. |---<Record 1 of 2>------------------------------------------------------------|
  287. | LASTNAME          FILINGDT   FILINGFEE      OTHERFEE   MARRIED   COMMENTS    |
  288. |------------------------------------------------------------------------------|
  289. | Adams           | 10/10/89 |        14.00 |     1.00 |    T    |   <Memo>    |
  290. | Smith           | 11/12/89 |        10.00 |     9.00 |    F    |   <Memo>    |
  291. |                 |          |              |          |         |             |
  292. |                 |          |              |          |         |             |
  293. |                 |          |              |          |         |             |
  294. |                 |          |              |          |         |             |
  295. |                 |          |              |          |         |             |
  296. |                 |          |              |          |         |             |
  297. |                 |          |              |          |         |             |
  298. |                 |          |              |          |         |             |
  299. |                 |          |              |          |         |             |
  300. |                 |          |              |          |         |             |
  301. |                 |          |              |          |         |             |
  302. |                 |          |              |          |         |             |
  303. |---<ALT-R to Reposition>------------------------------------------------------|
  304.  
  305.     (7)  If you wish to reposition to a particular record in the file, you may
  306.          press the ALT-R key which will display a light-bar menu in the middle
  307.          of the browse window as shown below.  To move to the Bottom of File,
  308.          simply highlight this option and press <ENTER>.  To move to a parti-
  309.          cular record number, highlight the Pick Record # option, press <ENTER>,
  310.          type in the desired record number, and press <ENTER>.  If your file is
  311.          indexed, you can move to the closest matching key to any value you
  312.          enter by highlighting the Matching Key option, pressing <ENTER>,
  313.          typing all or part of the key to find, and pressing <ENTER> again. 
  314.          Please note that if your lead index is a date field, the date to find
  315.          must be entered in the format YEAR, MONTH, DAY.  For example, if the
  316.          FILINGDT field entry for 11/12/89 was desired, you would enter
  317.          19891112 and press <ENTER>.                             
  318.                                                                  
  319.                                                                  
  320.                |-------------------------------------------------|
  321.                | Use Arrows to MOVE, <CR> to EDIT, <ESC> to quit |
  322.                |     ^Home - 1st Field   ^End - Last Field       |
  323.                |    ^PgUp - 1st Record   ^PgDn - Last Record     |
  324.                |-------------------------------------------------|
  325.                 
  326. |---<Record 1 of 2>------------------------------------------------------------|
  327. | LASTNAME          FILINGDT   FILINGFEE      OTHERFEE   MARRIED   COMMENTS    |
  328. |------------------------------------------------------------------------------|
  329. | Adams           | 10/10/89 | |================| 1.00 |    T    |   <Memo>    |
  330. | Smith           | 11/12/89 | |Top of File     | 9.00 |    F    |   <Memo>    |
  331. |                 |          | |Bottom of File  |      |         |             |
  332. |                 |          | |Pick Record #   |      |         |             |
  333. |                 |          | |Matching Key    |      |         |             |
  334. |                 |          | |Abort Search    |      |         |             |
  335. |                 |          | |                |      |         |             |
  336. |                 |          | |                |      |         |             |
  337. |                 |          | |                |      |         |             |
  338. |                 |          | |                |      |         |             |
  339. |                 |          | |                |      |         |             |
  340. |                 |          | |================|      |         |             |
  341. |                 |          |              |          |         |             |
  342. |---<ALT-R to Reposition>------------------------------------------------------|
  343.                                 
  344.                                 
  345.     (8)  There are two ways to change existing data.  You may simply type over
  346.          the data that is already there.  If you start typing, the rest of the
  347.          current field will be erased automatically.  Or, you may move to the
  348.          desired field, press <ENTER>, and then begin typing the new data.  In
  349.          the latter case, existing data will NOT be erased when you start
  350.          typing.  Press CTRL-Y to delete from cursor to end of field.  When the
  351.          data has been entered as desired, press <ENTER> to SAVE your changes.
  352.                                 
  353.     (9)  If you begin changing a field and discover you have made a mistake,
  354.          simply press <ESC> to restore the original entry.
  355.                                 
  356.     (10) To mark a record deleted, move the cursor to the desired record, and
  357.          press either the <DEL> key or <CTRL-U>.  To unDelete a record marked
  358.          for deletion, repeat this process again.  In short, <DEL> and CTRL-U
  359.          toggle the delete function ON and OFF.
  360.                                 
  361.     (11) To edit MEMO fields, highlight the desired field in the desired record. 
  362.          The middle of the BROWSE SCREEN will tell you whether the MEMO field 
  363.  
  364. contains data.  Press <ENTER> to edit the field. To SAVE your changes, press
  365. CTRL-W.  To exit without saving your changes, press <ESC>.
  366.                                 
  367.     (12) Shown below is a sample memo field once the MEMO EDITOR is called by
  368.          pressing <ENTER> while positioned over a MEMO field.
  369.                                 
  370.                |-------------------------------------------------|
  371.                |Use Arrows to move, ^W to save&end, <ESC> to quit|
  372.                |   ^Home - Top of Memo   ^End - End of Memo      |
  373.                |    PgUp - Up 1 Screen   PgDn - Down 1 Screen    |
  374.                |-------------------------------------------------|
  375.                                                                  
  376. |---<Record 1 of 2>--------------<Memo Data>-----------------------------------|
  377. |    EDITING KEYS: ^W=SAVE  Esc=ABORT  ^N=LINE INS  ^T=WORD DEL  ^Y=LINE DEL   |
  378. |------------------------------------------------------------------------------|
  379. | |--------------------------------------------------------------------------| |
  380. | |Here is a sample comment for record 1.                                    | |
  381. | |                                                                          | |
  382. | |                                                                          | |
  383. | |                                                                          | |
  384. | |                                                                          | |
  385. | | MEMO FIELD: COMMENTS--------------------------------------------RAM: 60K | |
  386. |---<ALT-R to Reposition>------------------------------------------------------|
  387.                                                                               
  388.                                                                               
  389.     (13) If you wish to ADD new records to your existing data base while in   
  390.          POWER BROWSE mode, move to the bottom of the file using either the   
  391.          cursor keys, CTRL-PgDn, or the ALT-R function.  Then press the <Down>
  392.          cursor key.  A beep will tell you that you are adding a new record to
  393.          the data base.  To abort the process, press the <Up> arrow.  Otherwise,
  394.          type the desired data and press <ENTER> to save each new field entry. 
  395.          NOTE:  You cannot add data to a MEMO field while in ADD mode without 
  396.          first adding data to some other non-MEMO field in the new record.    
  397.                                                                               
  398.                                                                               
  399.                |-------------------------------------------------|            
  400.                | Use Arrows to MOVE, <CR> to EDIT, <ESC> to quit.|            
  401.                |     ^Home - 1st Field   ^End - Last Field       |            
  402.                |    ^PgUp - 1st Record   ^PgDn - Last Record     |            
  403.                |-------------------------------------------------|            
  404.                                                                                
  405. |---<Adding Record 3>----------------------------------------------------------|
  406. | LASTNAME          FILINGDT   FILINGFEE      OTHERFEE   MARRIED   COMMENTS    |
  407. |------------------------------------------------------------------------------|
  408. | Adams           | 10/10/89 |        14.00 |     1.00 |    T    |   <Memo>    |
  409. | Smith           | 11/12/89 |        10.00 |     9.00 |    F    |   <Memo>    |
  410. | *************** |   /  /   |         0.00 |     0.00 |    F    |   <Memo>    |
  411. |-------------------------------<Add Record>-----------------------------------|
  412.                                                                                
  413.                                                                                
  414.     (14) SPECIAL NOTE:  The usual WAMPUM Edit Checks are not executed when you 
  415.          add or change data using the POWER BROWSE option.  This is the reason 
  416.          the function is reserved for those with the DEVELOPER PASSWORD only!  
  417.                                                                                
  418.     (15) When you finish using POWER BROWSE, simply press <ESC> to exit.       
  419.          Confirm your desire to exit by typing Y.  The Main Menu will reappear.
  420.                                                                          
  421.  
  422. II.  "Pop-Up" Relational Tables for Table Lookup                         
  423.                                                                          
  424.     Now you can design up to 9 "pop-up" tables to assist end-users with data
  425. entry.  They can choose any desired entry in the table and simply press the
  426. <ENTER> key to stuff one or more entries in the lookup table into the foreground
  427. data entry screen.  The developer can either define which fields get stuffed
  428. when the end-user selects an entry, or the developer can leave it up to the end-
  429. user to determine which field to stuff.                                  
  430.                                                                          
  431.     An example may help.  Suppose one is entering orders into a customer order
  432. data base for a parts supplier.  Rather than having to type the customer's name,
  433. address, city, state, and zip code each time the customer orders a product, we
  434. would like to look up this information in a "pop-up" customer file and "stuff"
  435. the necessary data into our orders file.  We also would like to do the same
  436. thing with the various parts that a customer wishes to order.  In other words,
  437. we want to look up the part number, the part name, and the cost of the part.
  438.                                                                          
  439.     WAMPUM now lets you design 9 such tables and "store" them under 9 "hot-keys"
  440. so that a user can press ALT-1 through ALT-9 and "pop-up" the desired table at
  441. any time while adding or editing records using the A - ADD or E - EDIT options.
  442.                                                                          
  443.     To create table lookup applications, you must do three things.  First,
  444. create the TABLE.DBF file structure shown below using the B - BUILD NEW FILE
  445. option, or you may simply copy the TABLE.DBF file provided on the distribution
  446. diskette into each application directory you create.  Second, create the table
  447. file (such as the CUSTOMER file or PARTS file described above) and any desired
  448. index to order entries within the file.  Third, create an entry in the TABLE
  449. data base file to describe which hot key the user should press and what should
  450. happen when the key is pressed.                                          
  451.                                                                          
  452.                                                                          
  453.                        Step 1 - Building A New TABLE.DBF File            
  454.                                                                          
  455.     Start WAMPUM in Developer Mode by typing WAMPUM VOODOO.  Choose B - Build
  456. New File.  When prompted for a file name, type TABLE and press <ENTER>.  Type in
  457. the following entries:
  458.  
  459.           NUM  FLD NAME      TYPE      FLD LEN     FLD DEC
  460.           ---  ----------    ----     ---------    -------
  461.            
  462.             1  FILE           C           20          0
  463.             2  INDEX          C           20          0
  464.             3  PROMPT         C           40          0
  465.             4  DISPLAY1       C           10          0
  466.             5  DISPLAY2       C           10          0
  467.             6  DISPLAY3       C           10          0
  468.             7  DISPLAY4       C           10          0
  469.             8  DISPLAY5       C           10          0
  470.             9  DISPLAY6       C           10          0
  471.            10  DISPLAY7       C           10          0
  472.            11  DISPLAY8       C           10          0
  473.            12  DISPLAY9       C           10          0
  474.            13  FLDDATA1       N            3          0
  475.            14  FLDFILE1       C           10          0
  476.            15  FLDDATA2       N            3          0
  477.            16  FLDFILE2       C           10          0
  478.            17  FLDDATA3       N            3          0
  479.            18  FLDFILE3       C           10          0
  480.            19  FLDDATA4       N            3          0
  481.  
  482.           NUM  FLD NAME      TYPE      FLD LEN     FLD DEC
  483.           ---  ----------    ----     ---------    -------
  484.            
  485.            20  FLDFILE4       C           10          0
  486.            21  FLDDATA5       N            3          0
  487.            22  FLDFILE5       C           10          0
  488.            23  FLDDATA6       N            3          0
  489.            24  FLDFILE6       C           10          0
  490.            25  FLDDATA7       N            3          0
  491.            26  FLDFILE7       C           10          0
  492.            27  FLDDATA8       N            3          0
  493.            28  FLDFILE8       C           10          0
  494.            29  FLDDATA9       N            3          0
  495.            30  FLDFILE9       C           10          0
  496.            
  497.     When all entries have been typed, press <ESC>.  When asked whether to
  498. proceed with building the file, type Y.
  499.            
  500.     In the alternative, you may copy the TABLE.DBF file which was provided with
  501. your copy of WAMPUM.  You will need to copy it to EVERY directory in which you
  502. build a WAMPUM application unless you wish to leave it in the DOS PATH and
  503. access it from multiple WAMPUM applications.  The philosophy of designing WAMPUM
  504. applications and where to place system files is covered in the Developer's
  505. Section of the User's Guide.
  506.            
  507.                  Step Two - Creating the Relational Data Base
  508.            
  509.     This step obviously is application specific.  What information do your users
  510. need to look up without having to refer to printed lists, cheat sheets, and the
  511. like?  A sample application is stored in a directory on your disk named
  512. \WAMPUM\SAMPLE1.  Move to this directory by typing CD \WAMPUM\SAMPLE1 at the DOS
  513. PROMPT.  Print the README.DOC file in this directory by typing:
  514.            
  515.                          COPY README.DOC PRN
  516.            
  517.     Read the documenation then type WAMPUM VOODOO to start up WAMPUM.  This
  518. sample application contains two table lookup data bases: one for customers and
  519. one for parts.  Notice that each is indexed on a key field. This enables quick
  520. retrieval of data in sorted order for display in the pop-up table.
  521.            
  522.     Add a record to the data base.  When the blank form appears, press ALT-9
  523. then <ENTER> to display the customer file.  Mundy will be highlighted.  Press
  524. <ENTER> to "stuff" Mundy's customer information into your order form.  Now press
  525. ALT-1 then <ENTER>, highlight a part, and press <ENTER> again.  This will
  526. "stuff" part information into the order form.  That's all there is to it!
  527.            
  528.            
  529.               Step Three - Building the Table Entry in TABLE.DBF
  530.            
  531.     What makes all this magic work depends upon what you enter into the TABLE
  532. data base.  This data base determines which "hot-keys" are enabled and what
  533. happens when an end-user presses one of them.
  534.            
  535.     The record numbers of entries in the TABLE.DBF file correspond to the "hot-
  536. keys" they will activate.  In short, if entries are made in record 1, then these
  537. entries will be executed when the user presses the ALT-1 "hot-key."  If entries
  538. are made in record 2, these are executed by pressing ALT-2.  And so on.  Up to 9
  539. records can be added to the TABLE.DBF file corresponding to ALT-1 thru ALT-9. 
  540. Any blank records in TABLE.DBF are ignored and will not activate a hot-key.
  541.  
  542.     Let's examine a typical TABLE.DBF entry:
  543. |--------------------------------------------------------------------------|
  544. |Record No.      1                                                         |
  545. |                                                                          |
  546. |FILE| PART                 INDEX| PART                                    |
  547. |                                                                          |
  548. |PROMPT| Enter part name or <ENTER> for all:      DISPLAY1|PART            |
  549. |                                                                          |
  550. |DISPLAY2|PARTNO      DISPLAY3|ONHAND      DISPLAY4|COST                   |
  551. |                                                                          |
  552. |DISPLAY5|PRICE       DISPLAY6             DISPLAY7                        |
  553. |                                                                          |
  554. |DISPLAY8             DISPLAY9             FLDDATA1   7  FLDFILE1|PARTNO   |
  555. |                                                                          |
  556. |FLDDATA2|  8  FLDFILE2|PART        FLDDATA3|  9  FLDFILE3|PRICE           |
  557. |                                                                          |
  558. |FLDDATA4      FLDFILE4             FLDDATA5      FLDFILE5                 |
  559. |                                                                          |
  560. |FLDDATA6      FLDFILE6             FLDDATA7      FLDFILE7                 |
  561. |                                                                          |
  562. |FLDDATA8      FLDFILE8             FLDDATA9      FLDFILE9                 |
  563. |                                                                          |
  564. |--------------------------------------------------------------------------|
  565.                                                                           
  566.     And here is the ORDERS data entry screen that the entry above would support. 
  567. Asterisks show where the looked up data will be stuffed by WAMPUM.  
  568. |----------------------------------------------------------------------------|
  569. |Record No.      2                                                           |
  570. |CUSTOMER Mundy, Ward           ADDRESS 4160 Club Drive                      |
  571. |                                                                            |
  572. |CITY Atlanta          STATE GA               ZIP 30319       ORDERDT   /  / |
  573. |                                                                            |
  574. |PARTNO_1 *****       DESCRIP_1  *********  PRICE_1  *********  QUAN_1       |
  575. |                                                                            |
  576. |PARTNO_2             DESCRIP_2             PRICE_2       0.00  QUAN_2       |
  577. |                                                                            |
  578. |PARTNO_3             DESCRIP_3             PRICE_3       0.00  QUAN_3       |
  579. |                                                                            |
  580. |ORDER_TOT        0.00  ORDERNO                                              |
  581. |----------------------------------------------------------------------------|
  582.                                                                             
  583.     In the FILE field of TABLE.DBF, you enter the name of the data base to be
  584. used for the table lookup.  It may include a path if desired.  In the INDEX
  585. field, enter the name of the INDEX file, if desired.  If an index is used, the
  586. file will be sorted in the order of the index when the table is popped up. 
  587. Specifying a PROMPT determines whether the user will be asked to enter search
  588. criteria before the pop-up table appears.  The prompt should correspond to the
  589. INDEX which will be used for the lookup.
  590.  
  591.     The 9 DISPLAY fields permit you to define up to 9 fields from the table
  592. which should be shown when the table pops up.  If all the DISPLAY fields are
  593. left blank, then ALL fields in the table will be displayed and the user can
  594. browse through all of them.  This may or may not be what you desire.
  595.  
  596.     There also are 9 pairs of FLDDATA and FLDFILE fields.  This is where you
  597. tell WAMPUM which fields from the table lookup entry should be stuffed in which
  598. fields displayed on the data entry screen.  You do NOT have to specify any of
  599. these in which case the user could look at a table but could NOT stuff data from
  600.  
  601.  
  602. the table into the data entry form.  In the alternative, you may specify 1 to 9
  603. pairs of data to be stuffed into the data entry form.
  604.  
  605.     For example, FLDDATA1 above contains an entry of 7 and FLDFILE1 specifies
  606. PARTNO.  This means when the user chooses an entry in the table, WAMPUM will
  607. automatically move the PARTNO of the entry chosen to seventh field on the ORDERS
  608. data entry screen.  Looking at the primary data entry screen tells you that the
  609. seventh field is the first part number ordered field: PARTNO_1.
  610.  
  611.     Two alternatives are available in "stuffing" data.  Specifying a number in
  612. the FLDDATA1 field forces data into a specific field on the ORDERS data entry
  613. screen as was done above.  In some cases, however, you may wish to use one table
  614. to stuff data into a number of different fields on the data entry screen.  If
  615. FLDDATA1 had been left blank (i.e. 0), then WAMPUM will stuff PARTNO into the
  616. field where the cursor was when the pop-up table was activated.  The only
  617. drawback of the latter method is that multiple fields obviously cannot be
  618. stuffed with data simultaneously.  Since we wanted to look up a part name,
  619. number, and price above, the second approach simply would not be appropriate.
  620.  
  621.     Once you have completed the entries in the TABLE.DBF file, SAVE your work by
  622. pressing CTRL-W.  Then <ESC>ape to the Main Menu, and press ALT-0 to reload the
  623. default configuration.  Now try out your handiwork!
  624.  
  625.  
  626. III.  Using 5 Relational Data Bases for Reports & Labels
  627.  
  628.     Prior versions of WAMPUM already supported one additional relational table
  629. for relating during execution of reports and labels.  WAMPUM 4.2 expands this to
  630. five through the W - WAMPUM Preformatted Output option.  If you have existing
  631. WAMPUM applications, these can be modified by changing the structure of your
  632. WAMPUM.DBF files to the following:
  633.  
  634. NUM  FLD NAME      TYPE      FLD LEN     FLD DEC
  635. ---  ----------    ----     ---------    -------
  636.   1  DATAFILE       C            8          0
  637.   2  SORTINDX       C            8          0
  638.   3  RPTLBLFRM      C            1          0
  639.   4  OUTFILE        C            8          0
  640.   5  FONT           N            1          0
  641.   6  CRITERIA       C          213          0
  642.   7  DESCRIP        C           30          0
  643.   8  RELFILE        C            8          0
  644.   9  RELKEY         C            8          0
  645.  10  RELFILE2       C            8          0
  646.  11  RELKEY2        C            8          0
  647.  12  RELFILE3       C            8          0
  648.  13  RELKEY3        C            8          0
  649.  14  RELFILE4       C            8          0
  650.  15  RELKEY4        C            8          0
  651.  16  RELFILE5       C            8          0
  652.  17  RELKEY5        C            8          0
  653.  
  654.     New applications automatically will have a WAMPUM.DBF file created with the
  655. above structure when you choose W - WAMPUM Preformat and tell the system to
  656. create the new file. Existing rules for relating data bases as outlined in the
  657. Second Edition User's Guide apply to the additional relations as well.
  658.  
  659.     A sample application demonstrating the new relational file capabilitity is
  660. stored on your disk in the \WAMPUM\SAMPLE2 directory.  Read its README.DOC file.
  661.  
  662. IV.  Computational Functions in Related Data Bases
  663.  
  664.     Prior versions of WAMPUM supported CALCULATED FIELDS in the primary data
  665. base through entries in the EDIT.DBF file.  See the Second Edition User's Guide
  666. for more information.
  667.  
  668.     WAMPUM 4.2 greatly expands this functionality by now allowing CALCULATED
  669. FIELDS in not only the primary data base but in any number of related data bases
  670. as well.
  671.  
  672.     The SAMPLE1 application in \WAMPUM\SAMPLE1 gives a good example of where
  673. this would be used.  You are filling orders for PARTS.  As you fill out an order
  674. form for parts, you would like the system to automatically reduce your existing
  675. inventory of the parts ordered by an amount corresponding to the quantity of
  676. parts sold.  Prior to WAMPUM 4.0, this typically required the services of a very
  677. skilled programmer.  Now, you can do it yourself.
  678.  
  679.     Read through the \WAMPUM\SAMPLE1\README.DOC file and then complete a couple
  680. of orders.  Change to the PART file and display several of the PART records, you
  681. will notice that the ONHAND quantities are decremented corresponding to the
  682. amount of parts you ordered.
  683.  
  684.     To set up a computational function in a related data base, you simply add a
  685. record to the EDIT.DBF file (after READING and FOLLOWING the rules outlined in
  686. the User's Guide with respect to record 1).  See the section in the User's Guide
  687. entitled "Using Table-Lookup for Calculated Fields."  It begins on page 64.
  688.  
  689.     The syntax is identical to that shown in the User's Guide on p. 65 with one
  690. enhancement.  For item 2(d), you now may enter either the field number of the
  691. field in the primary data base to be calculated OR you may enter the actual
  692. field name of a field in the related file specified in item 2(b).
  693.  
  694. V.  Using the UNIQUE table to calculate unique entries
  695.  
  696.     There are a number of times when you need to calculate a unique value for a
  697. particular field.  Account numbers, order numbers, part numbers, and the like
  698. all lend themselves to this.  WAMPUM 4.2 now will handle the calculation for
  699. you.  Here are the steps necessary to implement it.
  700.  
  701.     First, create a new database called UNIQUE.  Create a single field with a
  702. field name of UNIQUE, field type Numeric, and a field length of 5-9 digits
  703. depending upon your application.  Add one record to this file with the starting
  704. number.  The entry should be large enough to fill out all field positions with a
  705. number.  For example, if a five digit field is used, start with at least 10000.
  706.  
  707.     Store this file in the directory in which you are building your application
  708. that will rely on the UNIQUE table.  Add an entry to the EDIT.DBF table (with
  709. the caveats outlined above) which looks like the following:
  710.  
  711.     EDITTEST: #HELPCODE=1 .AND. EMPTY(FLDDATA[20])
  712.  
  713.     ERRMSG:   20,UNIQUE
  714.  
  715.     The # sign tells WAMPUM that this calculated field will rely upon the UNIQUE
  716. table.  Following the # sign, specify the logical expression telling WAMPUM when
  717. the calculation should be executed.  In this case, HELPCODE=1 tells WAMPUM to
  718. execute this instruction only when the user is in ADD RECORD mode.  The
  719. remaining condition assures that a table calculation is not performed if there
  720. already is an entry in the field.
  721.  
  722.     In the ERRMSG field, specify the number of the field to be calculated, then
  723. a comma, and then the expression to calculate the field value.  Looking at the
  724. ORDERS data entry screen several pages back reveals that the ORDERNO field is
  725. field #20.  Since it is a numeric field, the numeric contents of UNIQUE can be
  726. "stuffed" directly into the field.
  727.  
  728.     NOTE:  WAMPUM always increments the UNIQUE value by 1 BEFORE stuffing the
  729. value in the designated field.
  730.  
  731.     An example of the above is also contained in the \WAMPUM\SAMPLE1
  732. application.  Read the README.DOC file in that directory for additional details.
  733.  
  734.  
  735. VI.  "Pop-Up" Phone Dialer
  736.  
  737.     For those with a Hayes-compatible modem, WAMPUM now provides a pop-up phone
  738. dialer from the Main System Menu.  Make sure you connect a telephone to your
  739. modem's telephone output jack.
  740.  
  741.     Copy all of the PHONFILE files (PHONFILE.*) into each directory where you
  742. wish to use the pop-up phone dialer.  Or place these files in your DOS PATH.
  743.  
  744.     Run WAMPUM in Developer Mode by typing WAMPUM VOODOO.  Use F - File Select
  745. and choose the PHONFILE data base.  When the Main Menu reappears, you can use
  746. the A - Add Records option to add new entries to your phone file.  When you
  747. finish adding names and phone numbers, return to the Main Menu and press ALT-0
  748. to reload your default configuration.
  749.  
  750.     Choose the * - CONFIG Update option and enter the number of the COM port to
  751. which your modem is attached.  If you have TOUCH-TONE service and a Hayes-
  752. compatible modem, the MODEM INIT string should be fine.  Specify the time in
  753. seconds that WAMPUM should wait before redialing.  A value of 30 to 45 is
  754. recommended.  Then <PgDn> and SAVE your new configuration to disk.
  755.  
  756.     To use the phone dialer, return to WAMPUM's Main System Menu.  Press ALT-P. 
  757. The dialer menu will pop-up.  Highlight the person you want to call and press
  758. the <ENTER> key.  Or you can exit from the dialer by pressing <ESC>ape.
  759.  
  760.     The dialer should dial the desired number within 3 seconds.  Pick up your
  761. telephone and wait for the called party to answer.  When they answer, press
  762. either the <ESC> key or the space bar to turn OFF redial.
  763.  
  764.     If you get a BUSY signal, press <ENTER> to immediately redial the number.
  765.  
  766. VII.  "Pop-Up" DOS Applications Menu
  767.  
  768.     WAMPUM 4.2 now permits developers to build in as many external DOS
  769. applications to WAMPUM's Main Menu as desired.  Each application may use up to
  770. 512K memory provided you have at least a 640K system.  In short, end-users may
  771. now execute other DOS applications including word processors, communications,
  772. and spreadsheet software without ever leaving WAMPUM's Main Menu.
  773.  
  774.     The only system requirement is that you keep at least 512K of empty disk
  775. space since WAMPUM uses this work space when external applications are run.
  776.  
  777.  
  778.     A sample DOSAPPS.DBF file accompanies the software.  This data base can be
  779. changed to meet your individual needs.  There is no limitation to the number of
  780. applications which can be added to the file.  However, the applications will
  781. pop-up in the same order in which they are entered into the file.
  782.  
  783.     Here is a sample DOSAPPS data entry form.
  784.  
  785. |-------------------------------------------------------------------------|
  786. |Record No.      2                                                        |
  787. |PROGRAM Exit to Small DOS     SUPERVONLY F                               |
  788. |                                                                         |
  789. |COMMAND C:\command                                          TEMPDRIVE    |
  790. |                                                                         |
  791. |MEMORY 128  PAUSE F                                                      |
  792. |-------------------------------------------------------------------------|
  793.                                                                           
  794.     In the PROGRAM field, specify the text which should display for this  
  795. application when the user selects the ! - RUN External Program option.    
  796.                                                                           
  797.     In the SUPERVONLY field, type T or Y if only those running with the   
  798. developer password should have access to this application.  Otherwise, the
  799. application will be available to anyone who has privileges to use the ! option.
  800.                                                                           
  801.     In the COMMAND field, type the actual DOS command to be executed.  This may
  802. include a drive and path name with DOS 3.0 and higher IF the program does not
  803. rely on overlays OR if the program is stored in a DOS PATH directory.  The
  804. command must be the name of a file with an extension of .EXE, .COM, or .BAT. 
  805. Note that .BAT batch files may contain any combination of DOS commands.  If you
  806. use a batch file and change drives or directories, make certain that you change
  807. back to the appropriate drive and directory before exiting back to WAMPUM.
  808.                                                                           
  809.     In the TEMPDRIVE field, specify the drive where WAMPUM must have 512K of
  810. disk space for work space.  If the default drive has this must space, leave this
  811. blank.  If you have a RAMDRIVE with 512K free, this is the ideal drive.   
  812.                                                                           
  813.     In MEMORY, enter the maximum amount of memory which will be needed by this
  814. application.  If the number is too low, the application will NOT load.  If you
  815. leave it blank, WAMPUM will use all available memory up to 512K.  If your 
  816. program needs less memory than 512K, do NOT leave it blank.  Inserting a lower
  817. number will permit WAMPUM to load your application quicker.               
  818.                                                                           
  819.     Marking the PAUSE field True will cause WAMPUM to pause after you exit your
  820. applicaton before returning to the WAMPUM Main System Menu.               
  821.                                                                           
  822.     The sample above shows how one would specify an option allowing the user to
  823. exit to DOS.  The user then can return to WAMPUM by typing EXIT at the DOS
  824. prompt.                                                                   
  825.                                                                           
  826.     Important NOTE:  Since WAMPUM swaps a portion of itself to disk while other
  827. programs are running, there is NO performance degredation in running other DOS
  828. programs from within WAMPUM.  Once these programs are loaded into memory, they
  829. will operate just as if they had been run from the DOS prompt.            
  830.                                                                           
  831. VIII.  The DITTO hot-key                                                  
  832.                                                                           
  833.     By popular demand, we have added a DITTO "hot-key" that will duplicate any
  834. previously entered data for the same field in any other record.  The hot key is
  835. ALT-N and is available in both ADD and EDIT modes of WAMPUM.              
  836.  
  837. IX.  A Few Gotcha's to Watch Out For                                      
  838.                                                                           
  839.     When you create indexes within WAMPUM, the program records which indexes go
  840. with which data bases in a file called filename.mem where filename is the name
  841. of the data base.  Do NOT delete indexes at the DOS level!  Delete them within
  842. the I - Index Select/Create option.  In this way, WAMPUM will update the .MEM
  843. file correctly.  Otherwise, you will get smoke when you attempt to use the data
  844. base again.  If you forget and delete indexes at the DOS level, then simply
  845. delete the FILENAME.MEM file corresponding to the data base file name.  You then
  846. must reselect the indexes which go with this data base the next time you use it.
  847.                                                                           
  848.     The Browse functions have been reworked considerably from version 3.  If you
  849. wish to browse before editing or displaying complete records with E - Edit
  850. Record or D - Display Records, then press ALT-B to TURN ON BROWSE.  If you want
  851. to select fields to browse, mark the option Y, highlight the desired fields and
  852. press <ENTER>.  <ESC> when done.  Until you turn BROWSE OFF by pressing ALT-B
  853. again, you always will get a browse display when using display or edit options.
  854. Setting a BROWSE FIELD LIST in record 1 of EDIT.DBF is no longer supported.
  855.                                                                           
  856.     If you wish to permanently record the BROWSE status as well as the BROWSE
  857. FIELDS LIST, then first perform the steps in the paragraph above.  Now choose
  858. the * - CONFIG Update option.  When the configuration screen appears, press
  859. <PgDn>, then type Y to save the configuration to disk.  The POWER BROWSE  
  860. features described on page 5 of this file use the same FIELD LIST.        
  861.                                                                           
  862.     The hardest thing to learn in dBASE seems to be how to concatenate (join)
  863. two fields for a mailing label.  It is covered in detail in the Second Edition
  864. User's Guide.  It is repeated here for those that don't read that far.  You can
  865. only join character fields in dBASE.  If you wish to join fields which are not
  866. character fields, you must first convert them to character fields using a dBASE
  867. "function."  STR() is the numeric to string function.  It converts a number to a
  868. character field.  DTOC() is the date to character function.  It converts a date
  869. to a character field.  If you have a numeric field named FEE, you can convert it
  870. to a character string with the expression STR(FEE,7,2) where 7 is the TOTAL
  871. number of positions in the character string (including the decimal point, if
  872. any) and 2 is the number of decimals.  If you have a date field named BIRTHDAY,
  873. you can convert it to a character string with the expression DTOC(BIRTHDAY).
  874.                                                                           
  875.     Usually what causes mailing labels to self-destruct is a label format in
  876. which CITY and STATE are character fields and ZIP is a numeric field (a NO-NO!
  877. since some zip codes start with a zero which will NOT be preserved in a numeric
  878. field).  If you insist on leaving ZIP as numeric, then the correct expression to
  879. join these three fields AND trim off trailing spaces from the CITY field is as
  880. follows: TRIM(CITY)+", "+STATE+" "+STR(ZIP,5).  If the three fields were ALL
  881. character fields, the expression is TRIM(CITY)+", "+STATE+" "+ZIP.  The periods
  882. which end the two sentences above are NOT part of the expressions!  Whew! 
  883.                                                                           
  884.     Do NOT delete the MENU #'s list in the * - CONFIG Update option.  These are
  885. the item numbers on the Main System Menu.  For each number you delete, the
  886. corresponding option on the Main System Menu will NOT work!               
  887.                                                                           
  888.     The HEADING above the Main Menu can be changed easily by choosing * - CONFIG
  889. Update. It does NOT necessarily reflect the current WAMPUM version!  Read the
  890. logo after exiting to DOS to determine your current WAMPUM version.       
  891.                                                                           
  892.     The Clipper and dB-3 compatible index versions of WAMPUM do NOT support
  893. changing a field type in an existing file UNLESS you also change the field name. 
  894. Changing the field name will NOT preserve existing data!  You have several
  895. options if you want to preserve your data AND change the field type of an 
  896.  
  897. existing field in the data base.  First, if you have not yet entered data into
  898. the file, then just create a new data base from scratch.  Second, you may add a
  899. field to the existing data base with a new field name and the correct field
  900. type.  Leave the old one for the time being.  Once the file structure has been
  901. modified, then use the GLOBAL SEARCH and REPLACE option to "move" the old data
  902. into the new field.  Step 1 - Choose S - Select Utilities and enter a selection
  903. criteria of RECNO()>=1 which means ALL RECORDS.  Step 2 - Choose G - Global
  904. Search and Replace option.  Use the <Dn> arrow to choose the NEW field.  Press
  905. <ENTER>.  Type the expression necessary to copy the data from the old field. 
  906. REMEMBER: You MUST use a CONVERSION FUNCTION described above to convert the old
  907. data into the new TYPE data!  Once this finishes, look through your records to
  908. make sure you got what you wanted.  When you are satisfied, change the structure
  909. of your data base again by selecting B - Build New File then entering *.  Now
  910. delete the field you no longer need.                                      
  911.  
  912.     Finally, if you get errors every time you attempt to start up WAMPUM,
  913. chances are there is something wrong with your default data base.  You can get
  914. into WAMPUM easily if you first delete the WAMPUM.MEM file in the default data
  915. base.  Deleting this file means you are deleting your default configuration!
  916.  
  917.  
  918. X.  Loading WAMPUM as a TSR  (Version 4.1 enhancement)
  919.  
  920.     As with many features in WAMPUM, we endeavor to provide the latest and
  921. greatest bells and whistles in the industry. One such feature is the ability to
  922. load even very large programs (such as WAMPUM) as miniscule terminate-and-stay-
  923. resident programs (TSR's).  For those unfamiliar with TSR technology, it gives
  924. the user the ability to load a program into resident memory and then hide it
  925. from view while working with one or more other programs.  One past limitation of
  926. TSR's was their appetite for resident memory, often considerably more than 100K. 
  927. This made TSR's less and less desirable as newer programs required more and more
  928. RAM to execute.  With WAMPUM 4.2, you now can have your cake and eat it, too. 
  929. Once loaded as a TSR in background, WAMPUM consumes less than 20K!  It does this
  930. by saving most of the contents of its memory temporarily to someplace other than
  931. main memory.  It first looks to see if you have expanded memory, then extended
  932. memory, and finally to your default disk drive.  Between the three places, you
  933. MUST have at least 512K of space available.  Stated another way, if you have NO
  934. expanded or extended memory, you must have at least a half megabyte of free hard
  935. disk space on your default drive BEFORE loading WAMPUM as a TSR.
  936.  
  937.     WAMPUM 4.2 may be loaded as a TSR by including the word TSR on the command
  938. line when WAMPUM is started.  For example, WAMPUM TSR would load WAMPUM as a TSR
  939. while WAMPUM TSRDISK would load it as a TSR and force RAM contents to disk. This
  940. may be necessary with non-standard EMS or extended memory. If loaded from a
  941. batch file, make sure WAMPUM is the last command in the file!  Additional batch
  942. commands can be executed in a batch file (TSR.BAT) after loading WAMPUM as TSR. 
  943.  
  944.     Once WAMPUM is loaded as a TSR as described above, it can be popped up from
  945. within any other TEXT-BASED foreground application by pressing <ALT-W>.  From
  946. WAMPUM's Main Menu only, you then can put it back to sleep in the background by
  947. pressing <ALT-W>.  NOTE:  The reason for the limitation to WAMPUM's Main Menu is
  948. for YOUR protection. On this menu, all WAMPUM files are always CLOSED and SAFE!
  949.  
  950.     WAMPUM's speed in loading and unloading as a TSR is dependent upon several
  951. factors: the speed of your processor, the amount of extended and expanded memory
  952. you have, and (if you have less than 512K of free expanded or extended memory)
  953. the speed of your hard disk.  If you have a clunker XT with 640K and a hard disk
  954. which operates at the speed of a floppy, then WAMPUM's usefulness as a TSR will
  955. NOT be a pleasant experience.  On the other hand, if you have 512K of EMS memory
  956. free or a 30 millisecond hard disk, WAMPUM will pop up and down as a TSR almost
  957. instantaneously (with EMS memory) or VERY quickly (with fast hard disk). 
  958.  
  959. XI. Adding .PCX Images to Your WAMPUM Applications  (Version 4.2 enhancement)
  960.  
  961.     One of the major deficiencies in the data base market has been the inability
  962. to blend pictures and images into data bases.  For example, real estate appli-
  963. cations are much more meaningful if a picture of the property or its floor plan
  964. accompanies the other traditional data base information. In the insurance field
  965. the ability to capture a photo of a piece of property as part of the data base
  966. record would be invaluable.  In ID systems, adding photos and/or pictures of a
  967. signature or fingerprint provides a whole new dimension in the data base. And
  968. last but not least, collectors of all persuasions have asked for years for the
  969. ability to capture a picture of the collected item in their data bases whether
  970. they collect artwork, stamps, beer cans, baseball cards, race horses, or wives.
  971.  
  972.                  LINKING .PCX IMAGES TO YOUR dBASE DATA BASES
  973.  
  974.     Well, the wait is over!  WAMPUM now allows you to link images in the 
  975. industry-standard .PCX format to your dBASE-compatible data bases.  The steps
  976. to do this are outlined below.
  977.  
  978.     1.   Either create a new data base or use an existing dBASE data base.
  979.  
  980.     2.   Identify a CHARACTER-type field which will be used to store
  981.          the file names of the .PCX files. You can have more than one!
  982.  
  983.     3.   As you add records to your data base, type the name of the
  984.          .PCX file in this field.  For example, if you had a character
  985.          field named MLSNUM in which you stored the multiple listing
  986.          service number of a particular piece of real estate, then all
  987.          that is required to link a .PCX image of the same piece of
  988.          real estate to this record is to name the .PCX file the same
  989.          as the MLSNUM which was typed in this record.
  990.  
  991.     4.   WAMPUM assumes the image file's extension is .PCX unless you
  992.          specifically include a file extension.  Thus, if the MLSNUM
  993.          were 12345, the image file should be named 12345.PCX
  994.  
  995.                  DISPLAYING .PCX IMAGES WITHIN YOUR DATA BASES
  996.  
  997.     To display the .PCX files, you MUST have a graphics monitor which supports
  998. either VGA, EGA, or Hercules graphics.  If you have an older EGA card which
  999. requires software activation of Hercules-compatible graphics with a monochrome
  1000. display, make sure you do this before running WAMPUM.
  1001.  
  1002.     1.   .PCX images can be displayed in ADD, EDIT or BROWSE modes from
  1003.          WAMPUM's Main Menu.  If you choose to EDIT an existing record,
  1004.          then enter a key to display the desired record.
  1005.  
  1006.     2.   Move the cursor to the field you are using to identify your
  1007.          .PCX images.  E.g. move to MLSNUM in the example above.
  1008.  
  1009.     3.   Press <ALT-V> to view the .PCX image on your graphics monitor.
  1010.          If WAMPUM beeps at you, then one of several things has
  1011.          happened: either you don't have a graphics card installed or
  1012.          enabled, or the field is not a CHARACTER-type field, or there
  1013.          is no .PCX file with a name matching the data contained in the
  1014.          current field.  
  1015.  
  1016.          Usually the problem will be a missing .PCX file in your
  1017.          current directory or DOS PATH.  If the field value says 12345,
  1018.          then you must have a file named 12345.PCX in your directory.
  1019.  
  1020.                    PRINTING .PCX IMAGES FROM YOUR DATA BASES
  1021.  
  1022.     While the image is displayed on your screen, you may print it provided you
  1023. have (1) a graphics printer and (2) if you have previously loaded a graphics
  1024. print screen driver which supports your printer BEFORE running WAMPUM.
  1025.  
  1026.     DOS includes a GRAPHICS.COM program which will allow you to print graphics
  1027. images using an IBM or Epson-compatible dot matrix printer.  To load the driver
  1028. type GRAPHICS at the DOS prompt before running WAMPUM.
  1029.  
  1030.     If you have an HP LaserJet, there are several public domain or shareware
  1031. graphics printer drivers available in the marketplace.  Load one of these into
  1032. memory before running WAMPUM.  For other types of printers, you'll need to shop
  1033. around to find a graphics screen print utility that supports your printer.
  1034.  
  1035.     Once the graphics print driver has been loaded, simply follow the steps
  1036. above to display the graphics image within WAMPUM.  Then press <SHFT-PRTSCRN> 
  1037. to print the .PCX display  on your printer.
  1038.  
  1039.  
  1040.                        .PCX IMAGE FILES -- SPECIAL NOTES
  1041.  
  1042.     There are a few things to watch out for when using WAMPUM's graphics image
  1043. support.
  1044.  
  1045.     First, you must appreciate that there are thousands of different graphics
  1046. cards and monitors.  Most do what the salesman told you they would. A few 
  1047. don't.  If it doesn't work, it simply doesn't work.  We have tested WAMPUM
  1048. with Hercules, EGA, and VGA cards from the major manufacturers.  ALL of them
  1049. work!  We'd like to know about any incompatibilities, but we can't guarantee
  1050. we'll be able to make WAMPUM work with every quirky card and monitor around.
  1051.  
  1052.     Second, if you have a monochrome monitor and an EGA card, you should be
  1053. aware that the EGA card was designed to emulate BOTH the IBM monochrome
  1054. display card (which does NOT support graphics) and the Hercules graphics
  1055. card (which DOES support graphics).  You MUST configure the card to support
  1056. the latter.  This may require use of a software setting to enable Hercules
  1057. graphics mode. WAMPUM cannot distinguish between the two modes, and this may
  1058. cause your system to hang if the EGA card is set to non-graphics mode.
  1059.  
  1060.     Finally, for those new to graphics, you're probably wondering how to con-
  1061. vert your photograph into a .PCX file. The cheapest way is with a hand-scanner.
  1062. For about $150, you will get fairly good resolution black and white .PCX files.
  1063. At the other end of the spectrum, the sky is the limit in terms of cost.  The
  1064. most popular image capture card is the TARGA 16 with a retail price of $1995.
  1065. With this card, you can capture images directly from a video camera which can
  1066. output either an NTSC composite video signal (like a VCR) or an RGB analog one.
  1067. If black and white scans won't do, a color scanner such as Howtek's Scanmaster
  1068. can be had for $6,195.  It works well with the Targa 16 from Truevision.  You
  1069. then will need a program called T-EGA ($199) from Videotex Systems to convert
  1070. TARGA files to .PCX format.  Their number is 800/888-4336.
  1071.  
  1072.     The CHEAPEST OPTION for color projects is probably to have someone convert
  1073. pictures to .PCX files for you.  One such vendor is Graphic Edge. Their number
  1074. is 214/638-8416.  They charge about 15 bucks a picture for color.  ENJOY!!!
  1075.  
  1076.  
  1077.                  CUSTOMIZING THE GRAPHICS DISPLAY ENVIRONMENT
  1078.  
  1079.     WAMPUM deciphers most graphics cards correctly.  If you would prefer a dif-
  1080. ferent resolution or number of colors, you may override the settings which nor-
  1081. mally would be chosen by adding the following command to your AUTOEXEC.BAT file
  1082. or simply typing it at the DOS prompt before running WAMPUM: SET VM=mode where
  1083. mode is a number from the following table.  Default modes show an asterisk.
  1084.  
  1085. MODE        RESOLUTION  COLORS  HARDWARE REQ'D
  1086. ----        ----------  ------  --------------
  1087.  4          320 x 200      4    CGA/EGA/VGA
  1088.  6          640 x 200      2    CGA*/EGA/VGA
  1089. 13          320 x 200     16    EGA/VGA
  1090. 14          640 x 200     16    EGA/VGA
  1091. 15          640 x 350      2    EGA/VGA
  1092. 16          640 x 350     16    EGA*/VGA
  1093. 17          640 x 480      2    VGA
  1094. 18          640 x 480     16    VGA*
  1095. 19          320 x 200    256    VGA
  1096. 99            -->        -->    (mode is set by value stored in the .PCX file)
  1097. 200         720 x 348      2    Hercules*
  1098.  
  1099. SPECIAL NOTES: If you manually set MODE 19 with the command SET VM=19,
  1100. WAMPUM supports pre-version IV .PCX files with a palette file provided the
  1101. palette file has the same file name as the .PCX file with a .PAL extension.
  1102.  
  1103.     If you are capturing your own .PCX files and wish to use different reso-
  1104. lutions and numbers of colors for different images, then you should issue the
  1105. command SET VM=99.  In this case, WAMPUM will read the mode setting embedded
  1106. in the .PCX file and set the display adaptor accordingly.
  1107.  
  1108.     Our best advice is to first experiment with no setting of the VM variable.
  1109. If the results are unsatisfactory, then you may wish to manually try several
  1110. different video mode settings until you find one that meets your needs.
  1111.  
  1112.     DO NOT UNDER ANY CIRCUMSTANCES SET A VIDEO MODE OTHER THAN ONE OF THE
  1113.     NUMBERS SHOWN ABOVE.  DOING SO WILL ALMOST CERTAINLY SEND WAMPUM INTO
  1114.     THE OZONE THE FIRST TIME YOU ATTEMPT TO DISPLAY A .PCX IMAGE.
  1115.  
  1116.  
  1117.  
  1118.            WARD MUNDY SOFTWARE, 4160 CLUB DRIVE, ATLANTA, GA 30319
  1119.  
  1120.  
  1121.                     C U S T O M E R    I N V O I C E
  1122.  
  1123.  
  1124.  
  1125.      +---------------------------------------------------------------+
  1126.      |Customer:                          |Order Date:                |
  1127.      |                                   |---------------------------|
  1128.      |                                   |Shipped Dt:                |
  1129.      |                                   |---------------------------|
  1130.      |                                   |Invoice No:                |
  1131.      |                                   |---------------------------|
  1132.      |                                   |P.O. Number                |
  1133.      +---------------------------------------------------------------+
  1134.                                                                      
  1135.      +---------------------------------------------------------------+
  1136.      |QUANTITY |DESCRIPTION                   |UNIT PRICE|  AMOUNT   | 
  1137.      |---------|------------------------------|----------|-----------|
  1138.      |         |                              |          |           |
  1139.      |         |WAMPUM Second Ed. Users Guide |  20.00   |           |
  1140.      |         |                              |          |           |
  1141.      |         |WAMPUM 4.2 Single User License|  50.00*  |           |
  1142.      |         |                              |          |           |
  1143.      |         |WAMPUM 4.2 Network License    | 150.00*  |           |
  1144.      |         |                              |          |           |
  1145.      |         |WAMPUM 3.3 FoxBASE+ Single Lic|  50.00   |           |
  1146.      |         |                              |          |           |
  1147.      |         |WAMPUM 3.3 FoxBASE+ Network   | 150.00   |           |
  1148.      |         |                              |          |           |
  1149.      |         |WAMPUM 3.3 Floppy-Only License|  50.00*  |           |
  1150.      |         |                              |          |           |
  1151.      |         |WAMPUM Form Letter Editor     |  20.00   |           |
  1152.      |         |                              |          |           |
  1153.      |         |MenuMaker for WAMPUM/dLITE    |  20.00   |           |
  1154.      |         |                              |          |           |
  1155.      |         |dLITE 90-day ShareWare Lic.   |   5.00   |           |
  1156.      |         |                              |          |           |
  1157.      |         |dLITE Single User License     |  25.00   |           |
  1158.      |         |                              |          |           |
  1159.      |         |Badge-O-Magic 90-day ShareWare|   5.00   |           |
  1160.      |         |                              |          |           |
  1161.      |         |Badge-O-Magic License per PC  |  45.00*  |           |
  1162.      |         |                              |          |           |
  1163.      |         |Badge-O-Magic Network License |  95.00*  |           |
  1164.      |         |                              |          |           |
  1165.      |---------------------------------------------------------------|
  1166.      |* Specify INDEX: Clipper( )  dBASE III+(  )   3-1/2" disk?(  ) |
  1167.      |---------------------------------------------------------------|
  1168.      |         | Foreign Shipping Surcharge   |   5.00   |           |
  1169.      |         |                              |          |           |
  1170.      | Order   | Shipping & Handling Charges  |   5.00   |    5.00   |
  1171.      |         |                              |----------|-----------|
  1172.      |         |                              |  TOTAL   |           |
  1173.      +---------------------- Thank You! -----------------------------+
  1174.                                                                       
  1175.      TERMS: Please make check payable to Ward Mundy, 4160 Club Drive, 
  1176.               Atlanta, GA 30319.  Checks drawn on U.S. banks only!
  1177.